SetControlFontStyle

SetControlFontStyle
Header:	Controls.h		Carbon status:	Supported

Sets the font style for a control.

OSErr SetControlFontStyle (
    ControlRef inControl, 
    const ControlFontStyleRec *inStyle
);

inControl: A handle to the control whose font style is to be set.
inStyle: A pointer to a ControlFontStyleRec structure. If the flags field is cleared, the control uses the system font unless the control variant kControlUsesOwningWindowsFontVariant has been specified (control uses window font).

function result: A result code.

DISCUSSION

The SetControlFontStyle function sets the font style for a given control. To specify the font for controls in a dialog box, it is generally easier to use the dialog font table resource. SetControlFontStyle allows you to override a control’s default font (system or window font, depending upon whether the control variant kControlUsesOwningWindowsFontVariant has been specified). Once you have set a control’s font with this function, you can cause the control to revert to its default font by passing a control font style structure with a cleared flags field in the inStyle parameter.

VERSION NOTES

This function is available with Appearance Manager 1.0 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.